home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / f6fbb / editlbl.exe / arj / EDITLBL.DOC < prev    next >
Text File  |  1992-09-08  |  8KB  |  183 lines
  1.  
  2.  
  3.                             EDITLBL FOR F6FBB BBS SYSTEMS
  4.                             =============================
  5.  
  6.                              WRITTEN BY KEN WOOD (G3WCS)
  7.                              ===========================
  8.  
  9.  
  10.        OVERVIEW
  11.        ========
  12.        This small program is designed to manipulate the YAPPLBL.SYS file which
  13.        is  normally  found  in  the  SYSTEM directory of the F6FBB BBS system.
  14.        This file contains the real DOS path and  description  for  disk  files
  15.        which have been titled using the FBB LABEL command.  It is these titles
  16.        which  are  shown to users when they use the LIST command whilst in FBB
  17.        DOS.  These labels are also used by my REQDIR program to send  amateurs
  18.        requesting  a  directory  listing  a  description  of  each file.  This
  19.        facility  is  SysOp  configurable.  The file is not written in straight
  20.        ASCII format and is therefore not easily readable.
  21.  
  22.        A utility program, TLABEL, is provided with the BBS.  This  program  is
  23.        used to remove entries relating to files which no longer exist from the
  24.        YAPPLBL.SYS.   Sometimes,  it is possible for "rogue" entries to remain
  25.        in YAPPLBL.SYS which serve to slow down operation of the  LIST  command
  26.        and  also  the  REQDIR  server.   In addition, if the SysOp has to move
  27.        several disk files to a new directory, it  can  be  quite  a  chore  to
  28.        relabel  each  one  of  these  files from within the BBS.  EDITLBL will
  29.        allow this to be done more simply.
  30.  
  31.  
  32.        INSTALLATION
  33.        ============
  34.        Copy the program EDITLBL.EXE from the distribution disk into  the  same
  35.        directory  as  YAPPLBL.SYS.   This  will  normally be the C:\FBB\SYSTEM
  36.        sub-directory.  The program will report an error if  it  is  unable  to
  37.        locate YAPPLBL.SYS in the same directory.
  38.  
  39.  
  40.        OPERATION
  41.        =========
  42.        Do  not  run  the program with the BBS online.  The program is run from
  43.        DOS by optionally adding one command line argument as follows :-
  44.  
  45.        EDITLBL /?                   - Shows a help screen and version
  46.        EDITLBL                      - ASCII listing of YAPPLBL.SYS to screen
  47.        EDITLBL >  LPTn              - Above output  to  printer  n
  48.        EDITLBL  >  FILENAME.EXT     - Above output to disk file
  49.        EDITLBL /C                   - Compile YAPPLBL.ASC > YAPPLBL.SYS
  50.  
  51.  
  52.  
  53.  
  54.        WHAT IT DOES
  55.        ============
  56.  
  57.        [EDITLBL /?]
  58.        This provides a short help screen, similar to the  above  listing.   In
  59.        the event of a message to me, please quote the version number shown.
  60.  
  61.        [EDITLBL]
  62.        This command will produce an on screen ASCII listing of YAPPLBL.SYS.
  63.  
  64.        [EDITLBL > LPTn]
  65.        The file will be redirected to printer  n.   You  may  interchange  the
  66.        command  EDITLBL  >  PRN  if your system will support this.  Be advised
  67.        that each line might exceed 80 characters and it might be necessary  to
  68.        place your printer in compressed mode first.  This comment also applies
  69.        to the screen output above.
  70.  
  71.        [EDITLBL > FILENAME.EXT]
  72.        An  ASCII  file  will  be  generated  in the current directory with the
  73.        filename and extension supplied.
  74.  
  75.        [EDITLBL /C]
  76.        This  command  will  convert an ASCII file called YAPPLBL.ASC back into
  77.        YAPPLBL.SYS.  Note that the ASCII file must be in the  correct  format,
  78.        as per the file produced by EDITLBL > FILENAME.EXT.  See below for more
  79.        details.
  80.  
  81.  
  82.        EDITING
  83.        =======
  84.        One of the most valuable aspects of this  program  is  the  ability  to
  85.        produce  an  ASCII file, edit it with a text editor and convert it back
  86.        into a new YAPPLBL.SYS.  This will be of  great  benefit  and  expedite
  87.        matters  when  moving large numbers of FBB DOS files from one directory
  88.        to another.  Provided the following simple instructions  are  followed,
  89.        no problems should be encountered.
  90.  
  91.        The  first  step  is  to  make  a backup of YAPPLBL.SYS and place it in
  92.        another  directory.   The  program  will  not  overwrite  an   existing
  93.        YAPPLBL.SYS,  instead it will rename it to YAPPSYS.BAK.  However, it is
  94.        better to be safe than sorry.  Next issue the command :-
  95.  
  96.        EDITLBL > YAPPLBL.ASC
  97.  
  98.        which will generate an ASCII file from YAPPLBL.SYS.  The next stage  is
  99.        optional  but will probably assist editing of the ASCII file.  It makes
  100.        use of the DOS SORT command  and  therefore  your  DOS  directory  must
  101.        contain  either  SORT.COM  or  SORT.EXE and a path to the DOS directory
  102.        must exist. Issue the command :-
  103.  
  104.        SORT < YAPPLBL.ASC > TEST.DOC.
  105.  
  106.        This process may take several minutes  to  complete  if  your  file  is
  107.        large.   A  sorted  version  called  TEST.DOC  will be generated in the
  108.        current directory.  Using a plain ASCII text editor you may now  change
  109.        or   add  directory  paths  or  file  descriptions  within  this  file.
  110.        Remember that there is no error checking  so  any  error  will  usually
  111.        cause  either  a  defective  YAPPLBL.SYS to be generated, or the labels
  112.        shown with the list command will not equate to the files themselves  !!
  113.        You may remove redundant lines from the file completely.
  114.  
  115.        A  few  words  of warning.  Ensure that your text editor does not embed
  116.        any "hidden" control codes and that  it  does  not  automatically  wrap
  117.        lines by inserting a carriage return after 80 or so characters.
  118.  
  119.        Do not remove the small square separation character  between  the  path
  120.        and  file titles. If you are adding new lines, the square separator can
  121.        be generated by holding down the ALT key and pressing the numbers 2 5 4
  122.        on the NUMERIC KEYPAD, one after the other.  Finally, release  the  ALT
  123.        key.   If  your editor is unable to generate the square by this method,
  124.        it is likely that it is not a plain ASCII editor and you should not  be
  125.        using  it to modify this file. The maximum number of characters you may
  126.        have for the path is 79 and the maximum for the label, 47.
  127.  
  128.        When you have modified and checked the file, delete the old version  of
  129.        YAPPLBL.ASC and then type :-
  130.  
  131.        REN TEST.DOC YAPPLBL.ASC
  132.  
  133.        to  rename  the  file  on  which  you have just been working.  Finally,
  134.        issue the command :-
  135.  
  136.        EDITLBL  /C
  137.  
  138.        to  read the file and generate a new YAPPLBL.SYS.  As mentioned before,
  139.        the existing YAPPLBL.SYS file will be  renamed  in  case  you  need  to
  140.        reuse  it. Don't forget that the program will only compile a file named
  141.        YAPPLBL.ASC although the other program option to generate an ASCII file
  142.        can produce any legal DOS named file.
  143.  
  144.        The  new  YAPPLBL.SYS  will  be  read by the BBS and if your work is in
  145.        order, produce the desired response to LIST commands.  Don't delete the
  146.        original YAPPLBL.SYS until you are certain that all is well.
  147.  
  148.        PASSING IT ON
  149.        =============
  150.        This  program  is  released  into the public domain and you are free to
  151.        pass it on to others, provided no charge either material or implied  is
  152.        levied.  My only stipulation is that the original archive is handed on.
  153.        This  is  to  ensure  that  new  users  will not only have the required
  154.        documentation but also that it  will  be  current  and  not  from  some
  155.        superseded package.
  156.  
  157.        Software passed on in contravention of the above will not be supported.
  158.  
  159.  
  160.        FINALLY
  161.        =======
  162.        Please report any problems or strange happenings to me by packet radio.
  163.        The  latest  versions  of  all  my  software are always available on my
  164.        landline modem port of GB7CHS.
  165.  
  166.  
  167.  
  168.        Ken Wood G3WCS
  169.        SysOp GB7CHS.#11.GBR.EU
  170.        Cheshire NTS Mailbox.
  171.  
  172.  
  173.        Modem Port - 0606 892326
  174.        Outside UK - +44 606 892326
  175.  
  176.  
  177.        V 1.01 -  8th September 1992
  178.  
  179.  
  180.        EDITLBL.DOC
  181.  
  182.  
  183.